home *** CD-ROM | disk | FTP | other *** search
/ Hardcore Gamer Resource Kit / Hardcore Gamer Resource Kit - Disc 1.iso / flight / fs5 / utils / genback / GENBACK.TXT < prev   
Text File  |  1994-12-22  |  3KB  |  99 lines
  1.                   ----------------------------------------
  2.                   GenBack : Reverse Engineering for BGLGEN
  3.                   ----------------------------------------
  4.                 Version 1.1a
  5.  
  6.  
  7. Version 1.0a
  8. Version 1.1a    Maintenance version: emulation of coprocessor
  9.                      error messages    
  10.  
  11.  
  12. Decompiles BGL files in the BGLGEN format.
  13. This program should allow to decompile a BGL file created with BGLGEN, edit 
  14. it via a text editor and compile it back with BGLGEN. This program is 
  15. released as a FreeWare, so you can copy and distribute it as you want, as 
  16. long as you distribute this text file with it.
  17. Supported Features : VOR, ILS, NDB, IMO Markers, ATIS, Airport Menus and 
  18. runways. 
  19.  
  20. You are advised that feedback is more than welcome: all comments or criticism
  21. will be considered on a constructive basis, and none will be considered as 
  22. minor or unnecessary. Contact: 
  23.  
  24. Olivier Briot : 
  25.         obriot@epi.univ-montp2.fr (Internet)
  26.         100443,3531 on Compuserve
  27.  
  28.  
  29. HOW TO USE :
  30. ------------
  31.  
  32. to decompile "file.bgl" into a text file "file.txt" type: 
  33.         
  34.         gbk file.bgl file.txt
  35.  
  36. All the file will be decompiled. If you wish to analyze only a specific part 
  37. of the file, this can be done by typing:
  38.  
  39.         gbk file.bgl file.txt param
  40.  
  41. where param is an integer, obtained by adding the values corresponding to the
  42. sections you wish to decompile :
  43.  
  44.         1       for sections 1-6 : synthetic scenery
  45.         2       for section 0: VOR - ILS
  46.         4       for section 14: NDB
  47.         8       for section 16: IMO Markers
  48.        16       for section 11: Airports menus
  49.        32       for section 13: ATIS Messages
  50.        64       for partial section 9 decoding : Runways
  51.  
  52. If you wish to obtain a full decoding of section 9, you may use another
  53. program of mine : BGL2BGS (version 1.0c at the time I type this note.)
  54.  
  55.  
  56. LIMITATIONS
  57. -----------
  58.  
  59. This little program is expected to work fine on files compiled with BGLGEN. 
  60. The analysis of section 9 is minimal: just necessary to extract the runways.
  61. If you decompile files created with another compiler, the analysis will stop
  62. in this section to the first unrecognized item, and a message "not compiled 
  63. with BGLGEN will appear". However, the analysis of other sections will be 
  64. done. Of course, it would have been possible to extract the runways in a file
  65. containing more than that in sec.9. I'm not sure this is worth the additionnal
  66. program lines... waiting for feedback.
  67.  
  68. I think you will understand that intensively testing this program has not been
  69. possible, due to the time it takes. THere will be bugs. Please inform me and 
  70. I'll correct it.
  71.  
  72. When you compile back a decompiled file, it will have the same length as the 
  73. original, IF THE ORIGINAL HAS BEEN COMPILED WITH BGLGEN. If this is not the 
  74. case, the length may change (due to text string optimization, performed by 
  75. some compilers). 
  76.  
  77.  
  78. CREDITS :
  79. ---------
  80.  
  81. All FS5 hackers are deeply indebted to Maurizio Gavioli (and contributors)
  82. for his FS5STRUC file. Enno Borgsteede has created the BGLGEN compiler. 
  83. By writing this program, I had another opportunity to appreciate his 
  84. excellent work.
  85.  
  86.  
  87. Good design !
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.